home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / comm2 / mmpgpm11.lha / MM_PGPManager.dok < prev    next >
PGP Signed Message  |  1996-05-14  |  11KB  |  346 lines
  1. -----BEGIN PGP SIGNED MESSAGE-----
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                __  __       __  __
  12.               /  \/  \     /  \/  \     _   _   _
  13.              / /\__/\ \   / /\__/\ \   |_) | _ |_)
  14.             /_/      \_\ /_/      \_\  |   |_| |    Manager
  15.  
  16.  
  17.  
  18.                               \  /   | |
  19.                                \/    |o|
  20.  
  21.  
  22.  
  23.                      © 1995/96 by Sebastian Bleikamp
  24.                         (All rights reserved.)
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. 1. Einführung:     PGP Manager - Was ist das ???
  32.    -----------
  33.  
  34. Diese Programm ist eine einfache Benutzeroberfläche für das Verschlüsselungs-
  35. Programm PGP in Verbindung mit Mailmanager. Es ist dafür gedacht, Nachrichten,
  36. besonders E-Mails, zu verschlüsseln oder zu entschlüsseln. Darüberhinaus
  37. gibt es einige Extrafunktionen, wie z.B. das Anhängen von Keyfiles.
  38. Auch beachtet dieses Programm E-Mail Adressen und läßt sie intakt.
  39.  
  40. Übrigends, Vorschlaege und Kritik sind jederzeit willkommen.
  41. Wenn sich jemand die Mühe machen sollte, diesen Dok auf Englisch zu
  42. übersetzten, dann werde ich ihm auf ewig (?) dankbar sein ... B)
  43.  
  44.  
  45.  
  46. 2. Rechtliches ...
  47.    -----------
  48.  
  49. Dieses Programm darf frei kopiert werden, solange es oder das Archiv,
  50. indem es sich befindet, nicht in irgendeiner Weise verändert wird.
  51. Weiterhin darf es nicht kommerziell verwertet werden.
  52. Wer dieses Programm klaut und als seines ausgibt, kann mit Strafen von
  53. bis zu 2 Gurus pro Tag rechen. ;-)
  54.  
  55. Ich (der Autor) übernehme für Schäden jeglicher Art, die durch dieses
  56. Programm, das Archiv oder seinen Inhalt auf irgendeine Weise entstehen,
  57. keine Haftung. Also:
  58.  
  59.               USE THIS PROGRAM AT YOUR OWN RISC !!!
  60.  
  61.  
  62.  
  63.  
  64. 3. Installation:
  65.    -------------
  66.  
  67. 1. Kopiere die im Archiv enthaltenen Files in die entsprechenden
  68.    Verzeichnisse, z.B. MM_PGPManager.rexx nach MM:Rexx/ .
  69.  
  70. 2. Verändere im File MM:Config/MM_PGPManager.cfg die Konfiguration.
  71.    Dabei ist zu beachten, daß bei allen Schreibfunktionen ein ASCII
  72.    Text entstehen muß, weil er sonst nicht in die Msg.-Base eingebunden
  73.    werden kann. Logisch, oder ?
  74.    Wenn es unbedingt sein muß, aber auch nur dann, ändere auch das Tempfile
  75.    und das Outputfile. Allerdings hab ich nicht probiert, ob alles dann
  76.    noch richtig läuft. Sollte es aber eigentlich.
  77.    Am besten ändert man nur die PGP-Pfade und das CON: Ausgabefenster.
  78.    Das Programm ist ansonsten schon optimal konfiguriert.
  79.    (Wenigstens für PGP2.6ui, welches ich benutze.)
  80.  
  81. 3. Um das Programm in die Menüzeile einzubauen, füge folgende Zeilen
  82.    in das File Mailmanager.cfg ein:
  83.  
  84. #BROWSEMENU     "PGP Read"    "RX MM:Rexx/MM_PGPManager.rexx %a %n GUI"   "."
  85.  
  86.  
  87. 4. Man verfahre nach Try-and-Error oder lese die Dokumenattion.
  88.    Übrigends gibts auch in dem Programm eine "Art" (Ab-Art ??) "Onlinehilfe", in der die
  89.    Funktionen noch mal kurz aufgelistet sind.
  90.  
  91.  
  92.  
  93.  
  94. 4. Wie geht was ??
  95.    ---------------
  96.  
  97. Der Aufruf von MM_PGPManager ist im Prinzip immer derselbe:
  98.  
  99. "rx MM_PGPManager.rexx <Area> <Message-Nr.> [Funktion]"
  100.  
  101. Wird als Funktion "GUI" oder gar nichts angegeben, öffnet sich
  102. die grafische Oberfläche auf dem MM Screen.
  103.  
  104. Ich denke mir, das meiste an dem Programm erklärt sich selbst.
  105. Viele der Eingaben werden durch Requester erledigt, z.B. die Auswahl der
  106. Public Keys geschieht in einem Multi-Select-Requester.
  107. Ich erkläre deshalb hier die Funktionen nur im Kurzformat.
  108.  
  109.  
  110. Beschreibung der Funktionen:
  111. - ----------------------------
  112.  
  113. Funktion:  Gui:                Beschreibung:
  114.  
  115. READ       Read / Read         Entschlüsseln und anzeigen einer Nachricht,
  116.                                benutzt den in der PGP-Konfig angegebenen
  117.                                Viewer.
  118. WRITE      Write / Write       Verschlüsseln der aktiven Nachricht mit einem
  119.                                Public-Key (oder mehreren).
  120. SIGN       Write / Sign        Unterzeichnen der aktiven Nachricht mit der
  121.                                Signature des Sysops.
  122. WRITES     Write / Write&Sign  Wie WRITE und SIGN zusammen.
  123.  
  124. GETKEYS    Read / Get Keys     Speichert alle neuen Public Keys der aktiven
  125.                                Message in den PublicKeyRing.
  126. ADDKEY     Write / Add Key     Hängt einen Public Key an die Nachricht an.
  127.  
  128. GETFILE    Read / Get File     Speichert die entschlüsselte Nachricht(/File)
  129.                                in einem File ab. Nützlich für verschlüsselte
  130.                                binary files wie z.B. Keys von Programmen.
  131. PUTFILE    Write / Put File    Verschlüsselt un hängt ein File an die
  132.                                aktive Nachricht an.
  133.  
  134. SAVE       Read / Save         Speichert den Plaintext an Stelle des
  135.                                verschlüsselten Textes ab. Alte Nachricht geht
  136.                                verloren !!!! (Vorsicht, siehe unten.)
  137. REMOVE     Read / Remove Sig.  Speichert die Message ohne Signature ab.
  138.                                Signature kann in einem File gespeichert werden.
  139.                                Verschlüsselte Nachrichten werden entschlüsselt.
  140.                                (Vorsicht, alte Nachricht geht verloren; siehe unten.)
  141.  
  142.  
  143.  
  144. 5. Tips & Tricks:
  145.    --------------
  146.  
  147. Bei manchen Funktionen muß man auf die Reihenfolge achten, in der
  148. sie gemacht werden. So bringt es einem wenig, wenn man einen Public Key
  149. an eine Nachricht anhängt, und diese dann verschlüsselt. Der Empfänger
  150. muß dann zweimal PGP starten, um den Key zu erhalten.
  151.  
  152. Auch ist es nicht sinnvoll, eine Nachricht per Hand erst zu signieren und
  153. dann zu verschlüsseln, weil sonst wieder das selbe Problem auftritt.
  154. Also lieber gleich WRITES benutzen.
  155.  
  156. Wenn man beim Public-Key-Requester auf Cancel geht, erscheint ein String
  157. Requester, in den man den Public-Key per Hand eintragen kann.
  158.  
  159.  
  160.  
  161.  
  162. 6. Known Bugs ???
  163.    --------------
  164.  
  165. I. Bei manchen Schreibfunktionen, die auf schon verschickte oder
  166. importierte Messages angewandt werden, verändern sich die Flags, ohne
  167. das man etwas dagegen tuen könnte.
  168. Das selbe gilt für alle Schreibfunktionen auf Messages mit SAFE Flag.
  169. Jenes verschwindet einfach.
  170.  
  171. II. Bei Lesefunktionen, die den Msg.-Text verändern, wird keine Rücksicht
  172. auf E-Mail Adressen im Message Body genommen.
  173.  
  174. III. Bei SAVE und REMOVE geht alles an Text, der außerhalb der PGP-Message
  175. steht, verloren.
  176.  
  177.  
  178.  
  179.  
  180.  
  181. 7. Dank:
  182.    -----
  183.  
  184. Einige Leute haben diese Programm erst möglich gemacht, also ist es wohl
  185. fair, sie hier zu erwaehnen:
  186.  
  187. Pino Aliberti,       für seinen erstklassigen Mailmanager.
  188. Philip Zimmermann
  189. & Peter Simons,      für das Programm PGP.
  190. Dominique Simon,     der mich auf die Idee für diese Programm brachte
  191.                      und seine Vorschlaege.
  192.  
  193. Die Redaktion des
  194. Amiga-Magzines,      die dieses Programm in der Rubrik "Public Domain"
  195.                      (4/1996)vorstellte. Leider wurde kein Autor genannt,
  196.                      weshalb sich das Programm um eine "About"-Funktion
  197.                      erweiterte.
  198.  
  199. All diejenigen,      die mir die Bugs berichteten und durch die es deswegen
  200.                      auch zu dieser Version kam.
  201.  
  202.  
  203.  
  204.  
  205. 8. Wohin mit den Beschwerden ?  ;-)
  206.    ---------------------------
  207.  
  208. Am besten an mich:
  209.  
  210.     Sebastian Bleikamp
  211.  
  212.     Internet (bevorzugt): bleikamp@mail.rhein-ruhr.de
  213.     Fido: 2:2448/10.131
  214.  
  215.     oder als Echo in die Area MM_SUPPORT.GER (wenn ich darf, Siggi)
  216.  
  217.  
  218.  
  219.  
  220. 9. History
  221.    -------
  222.  
  223.  
  224.    V.0.1  - Vorabversion, an einem Nachmittag voller Langeweile getippert.
  225.  
  226.  
  227.    Neu seit Version 0.1:
  228.  
  229.       + Globale Variablennamen geändert.
  230.  
  231.       + -> GetKeys : Fügt alle Keys aus einer Message zum Public-Key
  232.                      Ring dazu. (Wenn es der User bestaetigt... )
  233.  
  234.       + -> Save    : Entschlüsselt eine Nachricht und speichert sie dann als Klartext in die
  235.                      Msg.-Base.
  236.  
  237.     Neu seit Version 0.2:
  238.  
  239.       + E-Mails werden erkannt, und die Adressierung berücksichtigt.
  240.         Dazu wurden 2 Funktionen geschrieben: Get_MM_Msg und Edit_MM_Msg.
  241.         Sie lesen (wenn vorhanden) die E-Mail Adresse aus und schreiben sie nacher
  242.         wieder als 1. Zeile in die Msg.
  243.  
  244.     Neu seit Version 0.3:
  245.  
  246.       + Es gibt jetzt 2 Funktionen zum Verschluesseln der Messages:
  247.         Einmal wird die Message nur verschluesselt (WRITE) und bei der
  248.         anderen zusätzlich noch unterschrieben (WRITES)
  249.  
  250.       + Alle Texte jetzt in Englisch (außer den Docs ...)
  251.  
  252.       + Endlich:
  253.         Jetzt mit Doks !!!
  254.  
  255.     Neu seit Version 0.4:
  256.  
  257.       + Funktion PUTFILE:
  258.         Verschlüsselt ein File (auch binär) und hängt es im ASCII Format
  259.         an eine Message an.
  260.  
  261.       + Funktion GETFILE:
  262.         Speichert den Plaintext einer Message in ein File.
  263.         Sehr nützlich, wenn man verschlüsselte Binärfiles empfängt.
  264.  
  265.  
  266.     Neu seit Version 0.5:
  267.  
  268.       + Jetzt mit Requester, der die Public-Keys auflistet.
  269.         Wenn Abbruch eingegeben wird, kann man die User-ID per
  270.         Hand eingeben.
  271.  
  272.       + Jetzt mit GUI. Einfach spitze !!!
  273.  
  274.       + Jetzt mit Sicherheitsabfrage, wenn Messages bereits gesendet wurden,
  275.         importiert oder geschützt sind.
  276.  
  277.  
  278.     Neu seit Version 0.6:
  279.  
  280.       + Bug in der Funktion für die Public-Keyliste entfernt.
  281.         Routine optimiert.
  282.  
  283.       + Remove:
  284.         Beseitigt die Signature vom File, funktioniert wie SAVE.
  285.  
  286.       + Jetzt mit Verschlüsseln für mehrere User !!!
  287.  
  288.  
  289.     Neu seit Version 0.7:
  290.  
  291.       + Bessere Konfiguration.
  292.  
  293.       + Einige Bugs beseitigt, läuft jetzt zuverlässiger.
  294.         (Hoffentlich ...)
  295.  
  296.  
  297.     Neu seit Version 0.8:
  298.  
  299.       + Nachdem bei der Vorstellung in der Amiga 4/96 kein Hinweis auf den Autor
  300.         angegeben war, habe ich mich entschlossen, einen About Requester ins
  301.         Hilfe-Menue aufzunehmen.
  302.  
  303.       + Jetzt mit einfacher(er) Konfiguration durch Konfigfile !
  304.  
  305.  
  306.     Neu seit Version 1.0:
  307.  
  308.       + PGPManager funktioniert jetzt mit PGP 2.6.3i.
  309.  
  310.       + Mehrer Bugfixes. MM_PGPManager zeigte auf Grund eines
  311.         Formatfehlers so z.B. eine leere Public Key Liste an.
  312.  
  313.  
  314. Und jetzt: Version 1.1, Bugfix von Version 1.0 !!!!!!
  315.  
  316.  
  317.  
  318.  
  319. 10. Zukunft
  320.     -------
  321.  
  322. Zitat des Doks von Version 1.0:
  323.  
  324. "Ich denke, mit der Veröffentlichung der Version 1.0 ist die
  325. Entwicklung dieses Programmes abgeschlossen, solange nicht
  326. noch Bugs oder besondere Wünsche auftauchen.
  327. Für meinen Teil enthält das Programm jetzt alle
  328. nötigen und brauchbaren Funktionen von PGP, und ich
  329. weiss einfach nicht, was ich noch einbauen soll."
  330.  
  331. Das selbe gilt auch jetzt noch. Diese Version
  332. erschien nur wegen des Bugfixes.
  333.  
  334.  
  335.  
  336.  
  337.  
  338. -----BEGIN PGP SIGNATURE-----
  339. Version: 2.6.3i
  340. Charset: noconv
  341.  
  342. iQBVAwUBMZkLJedt17roIPApAQHZYAH+Omued5vVnkHuUhLjYBsY160A3CUGIhhB
  343. e5qKRG2tH2dH2Ge3jMJBsFuggaa3GCluDwE+/Qw+BKomZPfvr/B+3Q==
  344. =JNJu
  345. -----END PGP SIGNATURE-----
  346.